home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / showfiles.z / showfiles
Encoding:
Text File  |  2002-10-03  |  11.6 KB  |  265 lines
  1.  
  2.  
  3.  
  4. sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))                                                    sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      showfiles - show files belonging to installed products
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      sssshhhhoooowwwwffffiiiilllleeeessss [ ----BBBBCCCCFFFFHHHHLLLLMMMMSSSSUUUUaaaabbbbcccciiiillllmmmmoooossssttttuuuuxxxx ] [ ----rrrr target ] [ ----ffff distribution ]
  13.           [ product ... ] [ -------- file ... ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _s_h_o_w_f_i_l_e_s is a tool used to list files belonging to installed software
  17.      _p_r_o_d_u_c_t_s.  The ----ffff option can be used to list files in a software
  18.      distribution packaged in the _i_n_s_t(1M) archive format.
  19.  
  20.      Current command-line options are:
  21.  
  22.      _p_r_o_d_u_c_t
  23.           List only files belonging to the given product(s).
  24.  
  25.      -------- _f_i_l_e
  26.           List only files matching the specified file expression(s), which
  27.           must follow the -------- argument.  Filename expressions are those
  28.           described in _r_e_g_e_x_p(5), with special treatment of the asterisk **** and
  29.           period .... characters.  Unless preceded by a backslash \\\\, an asterisk
  30.           matches any sequence of zero or more characters, and a period
  31.           matches only a period.
  32.  
  33.      ----AAAA   Print absolute pathnames, including the effective root directory.
  34.  
  35.      ----BBBB   Show only "bad" files (files on disk are missing or unreadable).
  36.           (This is normally only useful when run as root, since files with
  37.           inadequate read permission show up as unreadable.)
  38.  
  39.      ----CCCC   Show in simplified "config file" format, which includes modification
  40.           information as well as the filename.
  41.  
  42.      ----DDDD   Downgrade the history file to the earliest patch compatible history
  43.           file format.
  44.  
  45.      ----EEEE   Enables the _i_n_s_t__t_e_r_s_e__m_o_d_e preference, but has no effect on
  46.           showfiles.  Provided only for compatibility with _i_n_s_t(1M) and
  47.           _s_h_o_w_p_r_o_d_s(1M).
  48.  
  49.      ----FFFF   Filter mode -- rather than checking all files in the history,
  50.           instead, check filenames read off of standard input.  This is
  51.           intended for use in commands of the type ffffiiiinnnndddd |||| sssshhhhoooowwwwffffiiiilllleeeessss ----FFFF
  52.           [[[[ooooppppttttiiiioooonnnn----lllliiiisssstttt]]]].  This option is slow because it requires building a
  53.           table of information about all installed files on the system.  When
  54.           using this option in conjunction with the -r option, all input file
  55.           pathnames passed via standard input must be prefixed with the path
  56.           passed to the -r option.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))                                                    sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----HHHH   Show only installed files that have an associated .O or .N .
  75.  
  76.      ----MMMM   Don't use the built-in pager.
  77.  
  78.      ----UUUU   Upgrade the history file to the latest known format.
  79.  
  80.      ----VVVV _p_r_e_f_e_r_e_n_c_e::::_v_a_l_u_e
  81.           Set an _i_n_s_t/_s_w_m_g_r preference to a given value.
  82.  
  83.      ----aaaa   AND operator -- ----ooooppppttttiiiioooonnnn1111 ----aaaa ooooppppttttiiiioooonnnn2222 searches for files that satisfy
  84.           both conditions.  This is the default (----ooooppppttttiiiioooonnnn1111 ----ooooppppttttiiiioooonnnn2222 is the same
  85.           as saying ----ooooppppttttiiiioooonnnn1111 ----aaaa ooooppppttttiiiioooonnnn2222).
  86.  
  87.      ----bbbb   Display sizes in blocks instead of the default bytes.
  88.  
  89.      ----cccc   Show only config files.
  90.  
  91.      ----ffff _d_i_s_t_r_i_b_u_t_i_o_n
  92.           Show files on a distribution.  Currently this prints out files only
  93.           in idb format:
  94.  
  95.  
  96.           -  File type (see long format below).
  97.           -  Mode (see _c_h_m_o_d(1)).
  98.           -  Owner.
  99.           -  Group.
  100.           -  Pathname of the installed file.
  101.           -  Source pathname (this field should usually be ignored by the
  102.              user).
  103.           -  Subsystem that owns the file.
  104.           -  Miscellaneous file attributes: checksum, size, compressed size,
  105.              associated pre, post and exitops, etc.
  106.  
  107.      ----iiii   Show only installed files (the default), as opposed to user files
  108.           (files that weren't created by _i_n_s_t/_s_w_m_g_r).
  109.  
  110.      ----kkkk   Do checksums for user files.
  111.  
  112.      ----llll   List in long format (the default).  Long format includes the
  113.           following fields, in order:
  114.  
  115.  
  116.           -  File type: ffffile, llllink, ddddirectory, bbbblock special, ccccharacter
  117.              special, FFFFifo, or ???? (unknown).
  118.           -  Checksum.
  119.           -  Size in blocks.
  120.           -  Name of subsystem owning this file.
  121.           -  Whether the file is a cccconfiguration file or a mmmmachine-dependent
  122.              file.
  123.           -  Pathname of file.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))                                                    sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      ----mmmm   Show only modified files (files that differ in size or checksum from
  141.           the file that was installed).  This requires checksumming each file,
  142.           so listing the ----mmmm late in the list of arguments is preferable from a
  143.           performance standpoint.
  144.  
  145.      ----nnnn   Show only files that were installed from an overlay product and did
  146.           not have a counterpart file in the base product.  These are new
  147.           files introduced in the overlay.
  148.  
  149.      ----oooo   OR operator -- ----ooooppppttttiiiioooonnnn1111 ----oooo ----ooooppppttttiiiioooonnnn2222 shows files that match either
  150.           option1 or option2.
  151.  
  152.      ----rrrr _t_a_r_g_e_t
  153.           Set the effective root directory from which the installation
  154.           database will be read.  By default, this is ////.
  155.  
  156.      ----ssss   View in short mode -- show only filenames, no other information.
  157.  
  158.      ----tttt   Test configuration mode -- exit with status 0 as soon as a file is
  159.           found that matches the given conditions, otherwise exit with status
  160.           1.  The file $_r_b_a_s_e/_v_a_r/_i_n_s_t/._c_o_n_f_i_g__c_h_a_n_g_e_d is used to accelerate
  161.           this in the case of sssshhhhoooowwwwffffiiiilllleeeessss ----tttt ----cccc ----HHHH (equivalent to vvvveeeerrrrssssiiiioooonnnnssss ----tttt
  162.           cccchhhhaaaannnnggggeeeedddd): the presence of this file (created by _i_n_s_t or _s_w_m_g_r)
  163.           indicates that there may be changed configuration files present on
  164.           the system.  If this file is absent, it means that a previous run of
  165.           sssshhhhoooowwwwffffiiiilllleeeessss ----ttttccccHHHH determined that there were no changed configuration
  166.           files present, and removed ._c_o_n_f_i_g__c_h_a_n_g_e_d.
  167.  
  168.      ----uuuu   Show only unmodified files.
  169.  
  170.      ----wwww   Show only files that were installed from an overlay product.
  171.  
  172.      ----xxxx   Extract files from the distribution into the target.  This option
  173.           can be useful in conjunction with -------- ffffiiiilllleeee to extract particular
  174.           files.  A distribution must also be specified using the ----ffff option.
  175.           Files are extracted into the current working directory, unless the
  176.           ----rrrr ttttaaaarrrrggggeeeetttt option is also specified, in which case files are written
  177.           into their normal location relative to the root directory of the
  178.           target.  Normally _i_n_s_t(1M) or _s_w_m_g_r(1M) should be used to install
  179.           software components, since sssshhhhoooowwwwffffiiiilllleeeessss ----xxxx does not update the
  180.           installation history database, execute auxiliary installation
  181.           commands such as exitops, install symbolic links, preserve modified
  182.           configuration files, or perform _r_q_s(1) processing.
  183.  
  184.      !!!!    Negate the option that follows, for example, sssshhhhoooowwwwffffiiiilllleeeessss !!!! ----mmmm is the
  185.           same as sssshhhhoooowwwwffffiiiilllleeeessss ----uuuu.
  186.  
  187. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  188.      1.   To find all files that are changed config files (files with .N or
  189.           .O) and print them in "config mode" (same as vvvveeeerrrrssssiiiioooonnnnssss cccchhhhaaaannnnggggeeeedddd):
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))                                                    sssshhhhoooowwwwffffiiiilllleeeessss((((1111MMMM))))
  203.  
  204.  
  205.  
  206.  
  207.                _ssss_hhhh_oooo_wwww_ffff_iiii_llll_eeee_ssss _----_cccc _----_CCCC _----_HHHH
  208.  
  209.      2.   To find all files that are changed config files (files with .N or
  210.           .O) OR files (config or otherwise) that have been modified since
  211.           installation:
  212.  
  213.  
  214.                _ssss_hhhh_oooo_wwww_ffff_iiii_llll_eeee_ssss _----_cccc _----_HHHH _----_oooo _----_mmmm
  215.  
  216.      3.   To find out which product on the current system or on a specified
  217.           distribution owns the file called _f_i_l_e_n_a_m_e:
  218.  
  219.  
  220.                _ssss_hhhh_oooo_wwww_ffff_iiii_llll_eeee_ssss _----_llll [ _----_ffff _d_i_s_t_r_i_b_u_t_i_o_n ] _|||| _gggg_rrrr_eeee_pppp _f_i_l_e_n_a_m_e
  221.  
  222.           The output consists of zero or more "long format" lines containing
  223.           the information that is known about the file; see the description of
  224.           ----llll (long format) above.
  225.  
  226. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  227.      inst(1M), showprods(1M), swmgr(1M), versions(1M).
  228.  
  229.      _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.